allowInterrupts
Type
property
Summary
Specifies whether the user can halt a handler with a key combination.
Syntax
set the allowInterrupts to {true | false}
Description
Use the allowInterrrupts property to prevent users from interrupting handlers that must run to completion. For example, some handlers that change data cannot be interrupted safely, because they will leave data in an inconsistent state if interrupted.
If the allowInterrupts property is set to true, the user can halt handlers by typing Control-period or Control-break (on Windows or Unix) or Command-period (on Mac OS). Setting this property to false disables this capability and ensures that the user cannot interrupt a handler.
If the allowInterrupts property is set to false and the user attempts to interrupt the handler, the interrupt function returns true. To provide a clean exit, check this function and do any needed cleanup tasks before exiting the handler.
Setting the allowInterrupts property to false is functionally equivalent to setting the cantAbort property to true for each open stack.
Before setting the allowInterrupts property to false, make sure all handlers that may be affected have been thoroughly tested. If allowInterrupts is set to false, you cannot interrupt a runaway handler with the standard key combination.
Examples
set the allowInterrupts to false
set the allowInterrupts to the hilite of button 1
Related
control structure: exit
function: interrupt
glossary: property, return, key combination, handler, Windows, exit, Mac OS, Unix
object: stack
property: cantAbort
command: unlock error dialogs
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile